Skip to content

002 docker localnet testing - #5

Merged
0xLeathery merged 23 commits into
mainfrom
002-docker-localnet-testing
Feb 11, 2026
Merged

002 docker localnet testing#5
0xLeathery merged 23 commits into
mainfrom
002-docker-localnet-testing

Conversation

@0xLeathery

Copy link
Copy Markdown
Owner

No description provided.

Ethan Hurst and others added 23 commits February 11, 2026 09:30
- Introduced a new tasks template to streamline feature development, including phases for setup, foundational work, user stories, and polish.
- Organized tasks by user story to facilitate independent implementation and testing.

docs: Create GEMINI development guidelines

- Documented active technologies, project structure, commands, and code style for the solhex project.

feat: Implement initial database migration for indexer service

- Created initial schema for indexer service with a checkpoints table to track last processed signatures.

chore: Add specification quality checklist for audit fixes

- Developed a checklist to ensure completeness and quality of specifications before planning.

chore: Create security audit fix requirements checklist

- Established a checklist to validate requirements for security audit fixes, focusing on completeness and verification rigor.

feat: Define indexer API contract with rate limiting

- Added OpenAPI specification for the indexer API, including endpoints for stats history and health checks.

feat: Document data model for audit fixes

- Created a data model specification detailing on-chain program state and indexer schema changes.

chore: Outline implementation plan for audit fixes

- Developed a detailed implementation plan for addressing audit findings, including project structure and technical context.

chore: Create quickstart guide for testing audit fixes

- Provided a quickstart guide outlining prerequisites and testing steps for the audit fixes.

chore: Document research and decisions for audit fixes

- Compiled research notes and decisions made during the audit fixes phase.

feat: Write feature specification for audit fixes

- Drafted a comprehensive feature specification detailing user stories, requirements, and success criteria for audit fixes.

feat: Add task list for audit fixes implementation

- Created a task list to track progress on audit fixes, organized by phases and user stories.

test: Implement tests for admin constraints in bankrun

- Added tests to enforce bounds on admin-controlled parameters in the on-chain program.

test: Establish tests for BPD math saturation in bankrun

- Created tests to verify that speed bonus calculations do not panic on overflow, ensuring robustness.
- Introduced speckit.constitution.agent for managing project constitution updates and synchronization.
- Added speckit.implement.agent to execute implementation plans based on defined tasks.
- Created speckit.plan.agent to facilitate implementation planning and artifact generation.
- Implemented speckit.specify.agent for generating feature specifications from user descriptions.
- Developed speckit.tasks.agent to generate actionable, dependency-ordered tasks from design artifacts.
- Added speckit.taskstoissues.agent to convert tasks into GitHub issues.
- Created prompts for each agent to streamline user interactions and inputs.
…e Claim System

- Implemented a multi-phase distribution mechanism for unclaimed airdrop tokens in Module 6, including lifecycle management, share-days calculation, batch processing, and anti-gaming protections.
- Introduced a Merkle tree-based token airdrop system in Module 7, featuring Ed25519 signature verification, time-based speed bonuses, and linear vesting for claims.
- Established claim flow, speed bonus mechanics, and double-claim prevention strategies in the Free Claim System.
- Added detailed diagrams and formulas for clarity on processes and calculations.
- Updated test cases in claimGuard.test.ts to use `crankDistribution` instead of `distributeInflation`.
- Increased stake amount for stakers to ensure rewards are non-zero after inflation accrual.
- Adjusted time advancement in tests to 5 days for better reward measurement.
- Added a slot advancement to prevent duplicate transaction detection during claims.

Add development guidelines for solhex project

- Created copilot-instructions.md with project structure, active technologies, and recent changes.

Document CLI interface for Docker localnet commands

- Added cli-interface.md detailing commands for starting and managing the localnet validator and PostgreSQL services.

Establish Docker Compose service contract for localnet testing

- Introduced docker-compose-contract.md outlining service definitions, contracts, and dependency graphs for validator and PostgreSQL services.

Define data model for Docker localnet testing environment

- Added data-model.md to describe entities, properties, and configurations for the localnet testing setup.

Create quickstart guide for Docker localnet testing

- Developed quickstart.md to provide step-by-step instructions for setting up and running the localnet environment.

Conduct research on Docker localnet testing environment

- Compiled research.md detailing decisions, rationales, and alternatives regarding base images, Solana CLI versions, validator flags, and health checks.

Implement bootstrap script for protocol initialization

- Added bootstrap script logic to initialize protocol state and fund wallets during container startup.

Establish entrypoint and signal handling pattern

- Configured entrypoint to use `tini` for proper signal handling and clean shutdown of the validator.
…strap script

- Create Dockerfile for Ubuntu 22.04 with Solana CLI and Node.js
- Add docker-compose.yml for orchestrating validator and PostgreSQL
- Implement entrypoint.sh to start the Solana test validator and run bootstrap
- Add bootstrap.ts to initialize protocol state and fund wallet
- Include smoke-test.ts for validating container functionality
- Add .dockerignore and .gitignore for Docker and Git configurations
- Create README.md for usage instructions and troubleshooting
- Add test-wallet.json for deterministic wallet keypair
- Include package.json for bootstrap script dependencies
- Create logs directory with .gitkeep to maintain structure
- Document findings, including high, medium, and low priority issues
- Verify cross-component parity between Rust and TypeScript implementations
- Assess architecture notes and test coverage gaps
- Inventory authority-gated instructions for governance review
- Highlight action items for immediate attention in Section A
@0xLeathery
0xLeathery merged commit 2686b61 into main Feb 11, 2026
0 of 5 checks passed
@0xLeathery
0xLeathery deleted the 002-docker-localnet-testing branch February 11, 2026 22:18
0xLeathery added a commit that referenced this pull request Mar 2, 2026
0xLeathery added a commit that referenced this pull request Mar 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant